Computer-implemented method^ ai*d system for automatically 
invoking a predetermined debugger command at a desired 
location of a single thread of a program 



FIELD OF THE INVENTION ^ 

This invention relates\ r to Vomputer program debuggers. 

^ BACKGROUND OF THE INVENTION : - r ) v ■ . y 

bs / Program debugging is dona in, one pf the following two 
5 fways. According to a first approach, 1 a debugger is used, a 
debugger Y>eing a tool that enables a partial execution of 
the program, stopping at predefined points such, as lines 
of code oA variable values. A second way is log-based 
debugging, therein print ^statements are added to the 

10 program, WherXa test is ■ executed ..a, log is created. This 

log is examined off-line by the ; programmer to look for 
places where thk behavior of"; the, program deviates from the 
expected behavior^. There al-sq exis^ debugging tools that 
display traces of \executions> and . . show what happens during 

15 the execution. Once^ the locaVipn^of a problem is found 

using these tools, o\her tools;, such- as *a debugger are used 
to debug the program. l;t ^;is," not :% possible, after 
identifying the location of, -the problem, "to return to the 
actual program to investigate the state of the program. 

20 Getting to the correct location using a debugger can be a 

difficult problem, becausfe* algorithmic debugging, i.e. 
locating a bug, is difficult .j'once a fault occurs. 
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.gor^hhmic debugging is ^used . to ,| support locating a defect 
once ck fault is found/* ' as ^described in web site 
http: / /wWw. cs . nmsu. edu/-mi;r^uAaadebug. html and "General- 
ized algo)$ithmic debugging and testing" by Peter Fritzson 
5 Bt al. appearing in "ACM Letters : % '6n programming languages 

and testing\ 1:303-322) .19&2"? -^k' 

There are many existing'^ ^debugging ' tools and there are 
several trace visualization ^todis'^aVailable/ but there are 

no tools that combine the -.use of debugging commands and 

' ' ' r> -' "v. 
10 trace control together. \: ."■ 

r 

SUMMARY OF THE INVENTION 

It is therefore an. .objects -jo.f'-'the invention to provide 
a method and system f or r automatically invoking a predeter- 
mined debugger command, .at a desired location of a single 
15 ^thread of a program. .^, r - ;~ -v? 

To thie end, there is^pr^ in accordance with a 

:st aspect of the. inventi6ri\ ( "a computer-implemented 
method for automatically , invoking „a ^predetermined debugger 
command at a oasired location.^ "pi a single thread of a 
20 program containing at ... least one . thread, . said method 

comprising: 

(i) embedding Mthin said 7 >. "single thread at said 
desired location thereof t a ■ utility which reads a 
trace file in\ which* t aaid predetermined debugger 

25 command has been, previously - embedded; and 

(ii) running the program, 'f or Reading said trace file 
and invoking said V^deter^mined debugger command. 

The method according to- ^tfte- ^invention thus combines 
log-based debugging and use: of a" "debugger. By such means, 
30 it is possible to examine the .log and then to start the 

program, using the debugger'; at- -a point '-selected by the 
user. Such an approach may be implemented, on large, multi- 
threaded programs containing 'hundreds of threads . 



15 tnre- 
firs" 
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Implementation is especially; difficult in the context 
of multi-threaded programs , .-owing to the fact that 
execution may result in different , interleaving each time 
the program is run. That is to" say that the mutual 
5 sequence in which more t'h^n. Jon£,'; thread perform their 

instructions may not be conatant/';>Vince from each thread's 
point of view, all that is.*; important is that it performs 
its own instructions in tfte '. correct * sequence providing 
that the integrity of the values ' of variables as read by 
10 the thread is not compromised. v 'Such integrity is assured 

by the replay mechanism as/ .explained below, • It does not 
matter if that sequence is; interrupted to allow another 
thread to perform instructions^. However, this may have an 
effect on correct generation .'of' the ' trace file. 
15 The solution according ' to ; the invention requires 

several components: ^ ■ ;. * .Ji 

~^7~~~7 (&) ins tr Lamentation^ ^scheme, which allows the 

/ \ser to put specialized" print statements in the 

L prvogram, both manually and, automatically, to 

20 crefete trace f ile?.. * \ .. / * * : 

(^) a moVified debugger^ : that cap. be executed 
"against" the trace files* This debugger, when 
encountering an instrumentation statement, will 
check tke trace' file. If the trace file 
25 contains V debugger . . command (such as show 

current program ^status) it will execute it, 
else it wil\ continue t if, appropriate. This is 
the appearances to fc-he* user. Implementation may 
be done without! modif ying^-the debugger. 
30 (i) a number of supporting \ algorithms used to 

re-execute the program .with the same multi- 
threading interleaving, and, : if needed, to 
create a naming scoeme for threads or to match 
between threads and' \races. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

In order to understand th;e,- invent ion and to see how 
it may be carried out in practice;/ /.a ..preferred embodiment 
will now be described, by : :^ : ay; >pf ' rion- limiting example 
5 only, with reference to; .^fche ' accompanying drawings, in 

which: V' f^;;i. 

Fig- 1 is a flow diagram^ .^showing the principal 
operating steps carried OLjfc"^" by * -a'-i method according to a 
first embodiment of the invention; -for -^invoking a debugger 
10 from a trace file; e - : 

Fig. 2 is a flow diagram s how i rig the principal 
operating steps carried by a- * . "Trace-Print" function 
inserted into program code in the method shown in Fig. 1; 

Fig. 3 is a flow diagram , showing the principal 
15 operating steps carried by a scheme for automatic naming 

of trace files as a function of- a^. creating thread's name; 

Fig. 4 is a pictorial, representation of a tree 
structure depicting a scheme for automatic naming of trace 
files as a function of a creating thread f s name; and 
20 Fig, 5 is a block diagram, 'showing functionally a 

system for carrying out the "inyention. 

DETAILED DESCRIPTION OF THE INVENTION 

Fig. 1 is a flow diagram- showing the main operating 
steps carried out by a method - according to a first 

25 embodiment of the invention" for invoking a debugger from a 

trace file. In common with known.* tracing.. techniques, print 
statements are inserted into the' {program source code so as 
to output the value of a ^specified .variable at each 
location in the program wheire t.he v yalue of the variable is 

30 significant and where it may -be important subsequently to 

invoke a debugger command However , unlike known tracing 
techniques, the print statements - 'fehat ^ are inserted into 
the program source code are a--* modified*- print function, 
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"Trace-Print"/ that operates ^differently according to 

whether or not a trace file, already exists. Specifically/ 

Vc * ■ 

the modified print functiori creates a trace file if the 
file does not exist, and writes 'the, value of the variables 
5 thereto. , ; , , - , - -> 

This having been done 4 ,, k*% pr 9 •gramme r takes the trace 
file and reviews it line ti</ V^rieXv , When he or she comes 
across a value which appears* susp.e.gt, a debugger command 
is either inserted into . thet,,t.race v .f ile before the line in 

10 the trace file corresponding t.p the suspect line or, 

alternatively substitutes .the. line containing suspect 
variable with a debugger coinniand -.*..* 

This having been done, the.; program is re-run. It is 
assumed that the program retraces its previous steps as 

15 recorded in the trace file until it reaches the first 

modified print function. - \ 

Fig. 2 shows the principal- operating steps carried by 
the modified print f unctionv : "trace-Print' 1 ■ Thus, as noted 
above, on determining that the 'file does not exist, the 

20 Trace-Print function creates a: trace file and writes the 

value of the variables thereto/However, if the trace file 
does already exist, then the ^current value of the variable 
output by the program at v.th<e-.-i ^current;, location of the 
Trace-Print function is compared with 'a respective line in 

25 the trace file* If they are different, the Trace-Print 

function construes the respective - line in the trace file 
as a debugger command and * invokes a debugger so as to 
execute the debugger command, v 

A particular example f bllfews >r wherein:- different compo- 

30 nents of the invention are ^described- in greater detail. 

Instrumentation: V: , 

Functions of the >fom - - Trace-Print (Trace-Name, 

Content) are added to the -.program. Preferably, this is 

done automatically, using a mehu>v^in all locations of a 
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specific type defined by the programmer (g.g* beginning of 
routines, places where a particular variable "X" is used, 
etc.). In the case of mult ^.-threaded programs, automatic 
choice of the trace granularity ensures replay ability. 
5 Alternatively, the Trace-Print \ functions may be added to 

the program manually. Replay^ -ability .*,is described in 
"Deterministic Replay of J^a^ltithreaded Applications", 
by Jong-Deok Choi and r{Ha£im^l Strnivasan, in the 
Proceedings of the ACM SIGKBTRICS '^symposium on parallel 
10 and distributed tools, 1998^^ : \;^; 

^u\Q KM /when the program Lss : .executed on a test-, a flag 
called ^compare" is added ! ^." I ,tS 2 /comparer false, then the 
Trace-PrinV function prints -Content into:* file Trace-Name 
in the form^Trace: Content" . 

15 if eompare= true, then -iithe program is executed under 

a modified debugger- ;/. 

Modified Debugger: -/.r.i vV % * * 

Whenever a Trace-Print" finct/ion is reached, if the 
content of Trace-Name is o'f ^ the %:f orm "Debug: Command", 
20 then this debugger command \ is .executed. As shown in Fig, 

2, such execution can be performecl either iteratively t or 
in batch mode. ^ '\. m ^ 

IF the content is of the form : "Trace: Content" , THEN 
IP the content in -the" trace' file equals Content 
25 of Trace-Print/ then continue; . *i v ^ 

ELSE raise the debugger^' at this point with the 
appropriate error message. y 

Alternatively, the fuhct ion "Trace-Print is modified 
such that if the file Trace^Name;. is one of the debug- 
30 trace file names it eitherVwritfes ; to the file as above or 

compares, much like the "-previpus implementation but 
implemented within the program, -possibly as a library. 
When a point is reached where 'the debugger is needed, it 
is invoked from within the^pro^ram. This implementation 
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will work only for debuggers \that can be invoked while 
the program is running, \ t as-,..is the .case with most 
debuggers- The advantage of tb.is . approach is that the 
debugger is not modified, and it is easy to port between 
5 debuggers- t '»./" : 

Alternatively, a new . application may be created that 
does not run under the/ debugger*- ' Such an application 
accepts as input a tra,ce ^.fA-l^ and a stream of outputs 
from the executing prpgrkml^.ri'd'vboin^ares the stream to the 

10 trace file. If the stream | 'is* "different, it halts the 

program and raises a debugger : .;,;S : uch an approach has the 
advantage that the user program; -4.3 not modified and the 
application is not language t specific: In either case, 
application of the debugger, .gives rise -to delays and it 

15 is therefore hard to break; the, - v prograrp exactly at the 

desired location. . . . . .. . 

One possible solution to * this is to employ an 
architecture called "King" "tor;", any other from the 
published solutions) for re-executing "the program with 

20 the same interleaving as frarVas-the Trace-Print function 

is concerned. The king"' '"is" a' \syndhronization object able 
to influence, record arid enforce' interleaving. 

The king architecture is- use&^to record the order in 
which concurrent programs K *are " J e'xeciited and to rerun 

25 concurrent programs in the v sake ; 6r similar order. This 

architecture is used to support- interactive definition* of 
timing related tests. The tester ''can select a thread and 
advance it to a chosen; program location* A King 
architecture contains the following elements: 

30 - The king architecture', has ' twa modes 'record 1 and 

'replay 1 . When the progranf "is run' in record mode, 
the king gets called when; au snapshot statement is 
reached. The king therr 'records the order in which 
snapshot operations -occurred. When the program is 
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run in 'replay 1 mode-,* "tiie : . king is called when 
snapshots statements '/ are^V'reached- The king then 
determines which thread, -to advance in order to 
force the recorded execution order,. 

5 - The king uses a language- to record and replay an 

execution order. The simplest possible language 
used by the king is a* 'sequence of commands each 
advancing a certain*, thread r to tiie next snapshot 
instruction, e.g., v •■ 1 

K . ' ' ' . - M 

10 thread 1 A; thread 1 B; thread 2; A; 

■ The user can use thisr.. language interactively to 
define the execution iorder ■ , 
When running multi-thread ^ragrams, each thread may 
write to its own trace file, .and when, the programmer 

15 analyzes the trace file, it must clear^ to - which thread 

the traced variables refer v To this end, some consistent 
naming scheme is required .that',-.- ensures that allocates a 
unique name to each thread- dependent trace ^f ile and 
ensures that each thread writes, .to" "its own trace file. . 

20 In an example of the present; invention, a method for 

identifying if there is rid ^correlation between threads 
and traces uses bipartite matching'. The method is based 
on the idea that initially r 'e v acH v thread is matched to all 
traces- As a thread prints - coiitenty the matching is 

25 restricted to the subset of the v traces that match that 

content- If there is no /bipartite .matching from the 
threads to the traces af ter ; a print, then the program is 

stopped so as to avoid * executing debugger commands 

''/*■** 

embedded in each of the traces ,ati the wrong time. 1 
30 Fig- 3 shows the principal^ . steps associated with a 

consistent naming algorithm according to the invention 
for threads based on the f 6*^1 owing observations: 
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m A thread always has a ApWrent-'fchread (except for the 
Main Thread - i.e. *ijbhe threads which starts the 
program). u , : >-J 

m Since each thread execute's' its i: code sequentially, 
5 the creation time of everyv* child : thread, per parent 

thread, is unique. - . : ..■ 

Assumptions : ° 

• When the system starts, . "there -i^ only a single 
thread, called the Main L tAre v ad, or the Root Thread. 

10 • There exists a thread " bou : nd f -dndex structure, i.e. 

for each thread created*,^ thetW is a data structure, 
which holds an index cbuhtfer^o 

• Update of the index counter is * atomic. 

• Thread creation time isf defined as the first time a 
15 thread was created (e.g. using the ' new command for 

thread object creation in'v-3"ava), rather than the 
time the new thread starts .-executing, which could be 
system dependent : and ^ inconsistent across prog'ram 
executions. . ■■ : ' -VV" v \ 

20 The algorithm: ^ . , > 

As the Main Threads ' starts," 4 ' it: is named as .Main, and 
an index structure is ' ' created 1 ) -fo'f it, whose index is 
initialized to be 1. For each; newly created child thread, 
at Thread creation time, do:~J ; - 
25 • Create child thread name by. lib in g its parent name as 

a prefix and its parent- -index as suffix. 

• Increase parent thread's- ind^ex. by 1; 

• Create an index structure for the child thread and 

initialize its index to 1 y : 
30 Fig. 4 is a pictorial -representation of a tree 

structure depicting the abbv^-described algorithm for 
automatic naming of trac<e w vfiles^ as a function of a 
creating thread's name. -S^nce v&'y definition, thread 
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creation time is unique ,; and, si rices, the creation time is 
used to produce a unique name ...for every newly created 
thread/ every thread during ^the.'.iif eti^e of a program has 
a unique name. In addition /^thls -'unique. ,name is preserved 
5 across program re-execution, .as' long f.,, as each thread 

maintains the same order of " child, thread creation. 

Fig. 5 is a block diagram showing functionally a 
computer- implemented system * 10 , .for, automatically invoking 
a predetermined debugger command, at a desired location of 

10 a single thread of a , prqgraig : containing at least one 

thread. The system 10 . compirises";a code modifier 11 for 
embedding within the pro^ramf ? thread at the desired 
location thereof a utility; whicK.;v ; reads a trace file in 
which the predetermined ^ .-iJebuggpr command has been 

15 previously embedded* A processor -.12 reads the trace file 

during running of the program* an[dir, invokes the predeter- 
mined debugger command. A filei management system 13 is 
coupled to the processor 12 sfnd is ^ responsive to the 
embedded utility for checking'/. "whether a trace file 

20 exists, and for creating the - f trace file if it does not 

exist. A file modifier 14 "coupled ;to > the file management 
system 13 is responsive to- the /trace " file being created 
for writing to trace file ^a/traced.. value of at least pne 
variable at the desired yl.ocatipn of the program, A 

25 comparator 15 is coupled'. t r o rthe processor 12 for 

comparing a current value of . the- ^least one variable with 
a respective line in the trace file- If they are 
different, the comparator /] 15 := construes the respective 
line in the trace file as a debugger .command and invokes 

30 a debugger so as to execute, the debugger -command. 

The program may be multi-threaded in which case 
there is further included \a replay mechanism 16 coupled 
to the processor 12 for reru'^ining^ the program with 
identical interleaving as \ £ far. as - instrumentation 

35 statements are concerned, t'h.e^-proc^ssor 12 may further be 
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adapted to run the program,-, f or: ! riding a modified trace 
file readable by the program wherein at least one traced 
value is replaced or augment pd.* by / ; the debugger command. 

Likewise, in the event ;thatv the ..system is used with 
5 multi-threaded program, theVfile, management system 13 may 
be adapted to create for each-' .thread a respective trace 
file having a name which is uniquely defined by a name of 
the respective thread, thereby, allowing "debugger commands 
embedded in any of the trace files to be executed during 

10 a respective one of the threads ... 

The file management system-,J.3. may also be responsive 
to a predetermined executionAindependerit naming scheme 
for automatically naming the, ..crace files. To this end, 
the file management system 1?. includes an assignment unit 

15 17 for assigning a root name! to .".a root thread, and a 

thread-bound index structure 18,- ""for holding .for each 
thread a corresponding index cc.untpr, which is atomically 
incremented upon thread creation. The assignment unit 17 
is responsive to creation of.' a child thread for assigning 

20 a name including a prefix . indicative of a name of a 

respective parent thread and ,a\. suffix indicative of an 
index counter of the respective parent thread. The 
assignment unit 17 is responsiye . .to* no .consistent naming 
being possible for attempting' a bipartite matching 

25 between the threads and the. ^traces ..such that every thread 

has a trace which contains what /the thread printed, and 
for stopping the program . ,so as to avoid executing 
debugger commands embedded. . in each of: the traces at the 
wrong time if bipartite matching, : is not possible. 

30 A bypass mechanism 18, coupled to the file modifier 

14 allows creation of the trace : . file to be .manually or 
automatically bypassed so that traces are created in 
respect of only a subset of. the threads. The processor 12 
may be adapted to read the, modified trace file in respect 

35 of local views of the threads-;p.nly, so as. to avoid a need 
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for synchronizing break-points . In, multiple threads of a 
multithreaded program- ' 

It will also be understood that the system according 
to the invention may be a suitably programmed computer. 
5 Likewise, the invention contemplates a computer program 

being readable by a computer .for - executing the x method of 
the invention- The invention 'further contemplates a 
machine-readable memory tangibly embodying a program of 
instructions executable by„ the machine for executing the 
10 method of the invention. 

In the method claims "that follow, alphabetic 
characters used to designate claim steps are provided for 
convenience only and do not imply rany particular order of 
performing the steps. * '• ■■ . •' 
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